EXHIBIT B 



package KnowledgeAgents; 

import se . * ; 
import gui . * ; 
5 import utils.*; 

import j ava . awt . * ; 

import j ava . awt . event . * ; 

import j ava .util . Stack; 

10 import java.io.*; 

/** 

* The user interface of the Agent. 
V 

15 public class AgentGUI extends Frame 

implements ActionListener, ItemListener 

{ 

Agent agent; 
Trace trace; 

20 

/* private gui instance variables */ 
CheckboxGroup queryType; 

Checkbox textQuery, linkQuery, repSites; 

private Text Field tf Query; 

CheckboxGroup engineOptions ; 

Checkbox allEngines, selectEngines; 

List engines; 

30 Checkbox fileSelect; 

private TextField tfOutputFile; 

private TextField tf ExpandFactor, tf RootSetSize, tfNumResults ; 

private TextField tfMaxLinkWeight , tfQueryRefine Factor; 
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35 

private TextField tfNSites, tf Phase, tfLeft; 

private TextField tfServQIn, tfServQOut, tfServQUtil; 

private boolean vis; 

private Button queryRefine, addSites; 
40 private Button searchLearn, searchOnly; 

/* public methods */ 
/** * / 

45 public AgentGUI (Agent agent. 
Trace trace ) 

{ 

this. agent = agent; 
this. trace = trace; 
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int gridy = 0, gridx =1; 

Font fntTitle = new Font ( "Helvetica" , Font. ITALIC, 18) 

Font fnt = new Font ( "TimesRoman", Font. PLAIN, 12) 

Font fntBold = new Font { "TimesRoman" , Font. BOLD, 12) 

Panel p = new Panel () ; 

ScrollPane scroll = new ScrollPane ( ) ; 

GridBagLayout gbl = new GridBagLayout ( ) ; 

GridBagConstraints c = new GridBagConstraints 0 ; 

vis = true; 
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p. setFont (fnt) ; 
p.setLayout (gbl) ; 



// prepare the panel's title 
/* 

GuiAddFields .AddLabel ("Knowledge Agent Window", 

true, 

70 0, gridy++, 4, 1, 

GridBagConstraints. CENTER, 
fntTitle, 

gbl, p ); 
GuiAddFields .AddEmptyLine (gridy++, fnt, gbl, p) ; 
75 GuiAddFields .AddEmptyLine (gridy++, fnt, gbl, p) ; 

*/ 

//***************★********************************************* 

GuiAddFields .AddLabel 
80 ("Enter Query/Add Repository Sites", 

false , 

0, gridy++, 2, 1, 
GridBagConstraints . CENTER, 
fntBold, 

85 gbl, p ); 

// add the radio buttons and the file dialog 
queryType = new CheckboxGroup ( ) ; 

textQuery = new Checkbox ("Text query", queryType, true) ; 

90 linkQuery = new Checkbox ("Sample URL query", queryType, false); 

repSites = new Checkbox ("Repository Sites", queryType, false); 

GuiAddFields .AddCheckbox (textQuery, 0, gridy, l,l,gbl,p, (Frame) this) ; 
tf Query = GuiAddFields .AddTextField 
95 (45, 

1, gridy++, 4, 1, 

GridBagConstraints .WEST, 

false, 

gbl, p ); 
100 tfQuery.setEditable(true) ; 

GuiAddFields. AddCheckbox( linkQuery, 0, gridy, l,l,gbl,p, (Frame) this) ; 
GuiAddFields. AddCheckbox (repSites, 0, gridy+1, l,l,gbl,p, (Frame) this) ; 

GuiAddFields. AddLabel (" Query Refinement Factor:", 

105 false, 

1, gridy, 2, 1, 
GridBagConstraints . CENTER , 
fnt, 

gbl, p ) ; 

110 tfQueryRef ineFactor= GuiAddFields .AddTextField 

(5, 

3, gridy, 1, 1, 
GridBagConstraints. WEST, 
false, 

115 gbl, p ); 

tfQueryRef ineFactor. setText ("2") ; 

queryRefine = GuiAddFields .AddBut ton ("Refine Query", 4, griciy++, 

GridBagConstraints . CENTER, 
gbl, p, (Frame) this) ; 
120 addSites = GuiAddFields. AddBut ton ("Add Sites", 1, gridy++, 

GridBagConstraints . WEST, 
gbl, p, (Frame) this) ; 
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GuiAddFields.AddEmptyLine (gridy++, fnt, gbl, p) ; 
125 //*********************************************************** 

GuiAddFields . AddLabel 

( "Choose Search Engines : " , 
false, 

0, gridy, 2, 1, 
130 GridBagConstraints .CENTER, 

fntBold, 

gbl , p ) ; 

GuiAddFields .AddLabel 

( "Various Arguments : " , 
135 false, 

3, gridy++, 2, 1, 
Gr i dSagCons tra int s . CENTER , 
fntBold, 

gbl , p ) ; 

140 

// add the radio buttons and the scrollable list 
engineOptions = new CheckboxGroup ( ) ; 

allEngines = new Checkbox ("All Engines", engineOptions, false) 
selectEngines = new Checkbox ("Select From List --> ", 
145 engineOptions, true ) ; 

GuiAddFields .AddCheckbox (allEngines, 

0, gridy, 1 , 1 , gbl , p, (Frame) this) ; 
GuiAddFields .AddCheckbox (selectEngines, 
150 0, gridy+1, 1 , 1 , gbl , p, (Frame) this) ; 

engines = new List (SearchEngine .NUM_ENGINES, true) ; 
for { int i=0; i < SearchEngine .NUM_ENGINES ; i++ ) 
engines .addit em (SearchEngine . engineNames [i] ) ,- 
155 GuiAddFields .AddComponent (engines, 1, gridy, 1 , 2 , gbl , p) ; 

GuiAddFields .AddLabel ("Max. Link Weight:", 

false, 

3, gridy, 2, 1, 
160 GridBagConstraints. CENTER, 

fnt, 

gbl, p ); 
tfMaxLinkWeight = GuiAddFields .AddTextField 

(5, 

165 5, gridy, 1, 1, 

GridBagConstraints. WEST, 
false, 

gbl, p ); 
tfMaxLinkWeight . setText ("1.25"); 
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gridy+=2 ; 

GuiAddFields.AddEmptyLine (gridy++, fnt, gbl, p) ; 



GuiAddFields .AddLabel 

("Set Size Restrictions", 
false, 

0, gridy++, 2, 1, 
180 GridBagConstraints .CENTER, 

fntBold, 

gbl , p ) ; 
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GuiAddFields.AddLabel ("Root Set Size:", 
185 false, 

0, gridy, 1, 1, 

Gr i dBagCons t ra i nt s . CENTER , 
fnt, 

gbl, p ); 
190 tfRootSetSize = GuiAddFields . AddTextField 

(3, 

1, gridy, 1, 1, 
GridBagConstraints.WEST, 
false, 

195 gbl, p ); 

tfRootSetSize. setText ("30") ; 

GuiAddFields.AddLabel ("Expand Factor:", 

false, 

200 2, gridy, 1, 1, 

GridBagConstraints , CENTER, 
fnt, 

gbl, p ); 
tf ExpandFactor = GuiAddFields . AddTextField 
205 (3, 

3, gridy, 1, 1, 
GridBagConstraints .WEST, 
false , 

gbl, p ); 
210 tf ExpandFactor. setText ("40") ; 

GuiAddFields . AddLabel ( "Show Best : " , 

false, 

4, gridy, 1, 1, 

215 GridBagConstraints. CENTER, 

fnt, 

gbl , p ) ; 

tfNutnResults = GuiAddFields .AddTextField 

(3, 

220 5, gridy++, 1, 1, 

GridBagConstraints. WEST, 

false, 

gbl, p ); 
tfNumResults. setText ("15") ; 

225 

GuiAddFields .AddEmpty Line (gridy++, fnt, gbl, p) ; 

230 GuiAddFields .AddLabel 

("Execution Trace", 
false, 

0, gridy++, 1, 1, 
GridBagConstraints .CENTER, 
235 fntBold, 

gbl , p ) ; 

GuiAddFields.AddLabel ("Number Of Sites:", 

false, 

240 0, gridy, 1, 1, 

GridBagConstraints . CENTER, 
fnt, 

gbl, p ); 
tfNSites = GuiAddFields. AddTextField 
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245 (5, 

1, gridy, 1, 1, 

GridBagConstraints.WEST, 

false, 

gbl, p ); 

250 tfNSites.setText ("0") ; 

tfNSites.setEditable(false) ; 

GuiAddFields . AddLabel ( "URLs Left : " , 

false, 

255 2, gridy, 1, 1, 

GridBagConstraints . CENTER , 
fnt, 

gbl , p ) ; 

tfLeft = GuiAddFields. AddText Field 
260 (4, 

3, gridy, 1, 1, 
GridBagConstraints .CENTER, 
false, 

gbl , p ) ; 

265 tfLeft , setText { " " ) ; 

tfLeft .setEditable{ false) ; 

GuiAddFields .AddLabel 

("Dedicated Rdrs:", 
270 false, 

4, gridy, 1, 1, 
GridBagConstraints .CENTER, 

fnt, 

gbl , p ) ; 

275 tfServQUtil= GuiAddFields .AddText Fie Id 

(3, 

5, gridy++, 1, 1, 
GridBagConstraints. WEST, 
false, 

280 gbl, p ); 

tf ServQUtil . setText { " " ) ; 
tfServQUtil .setEditable (false) ; 

GuiAddFields . AddLabel ( " Phase : " , 
285 false, 

0, gridy, 1, 1, 
GridBagConstraints. CENTER, 
fnt, 

gbl, p ); 
290 tf Phase = GuiAddFields .AddTextField 

(35, 

1, gridy, 3, 1, 
GridBagConstraints -WEST, 
false, 

295 gbl, p ) ; 

t f Phase. setText (" ") ; 
tf Phase . setEditable (false) ; 

tfServQIn = GuiAddFields .AddTextField 
300 (3, 

4, gridy, 1, 1, 
GridBagConstraints .WEST, 
false, 

gbl, p ); 
305 tfServQIn. setText ("") ,- 
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tfServQIn. setEditable (false) ; 
tfServQOut = GuiAddFields -AddTextField 
(3, 

5, gridy++, 1, 1, - 
310 GridBagConstraints.WEST, 

false, 

gbl, p ); 
tf ServQOut . setText ( " " ) ; 
tfServQOut . setEditable (false) ; 
3 1 5 GuiAddFields . AddLabel 

{"Pending Read Reqs/Ans", 
false, 

A, gridy++, 2, 1, 
GridBagConstraints .CENTER, 

320 fnt, 

gbl, p ); 

/^*it*1tit**1eit*ieie*irir*ic**iriric1r1ricieicit1ciciricicic4cie*1cir*iritiritifiririt* 

325 GuiAddFields . AddLabel 

("Choose Output File:", 
false, 

0, gridy++, 1, 1, 
GridBagConstraints . CENTER, 
330 fntBold, 

gbl, p ); 
GuiAddFields .AddBut ton ("Select File...", 0, gridy, 
GridBagConstraints .WEST, 

gbl, p, (Frame) this) ; 

335 

tfOutputFile = GuiAddFields. AddTextField 

(45, 

1, gridy, 4, 1, 
GridBagConstraints .WEST, 
340 false, 

gbl , p ) ; 

tfOutputFile . setEditable (true) ; 
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GuiAddFields .AddEmptyLine (gridy++, fnt, gbl, p) ; 



GuiAddFields .AddBut ton ("Trace...", 0, gridy, GridBagConstraints.WEST, 

gbl, p, (Frame) this) ; 
350 GuiAddFields .AddEmptyLine (gridy++, fnt, gbl, p) ; 

//**************************************************★ 

GuiAddFields .AddButton ("Save State", 0, gridy, 
355 GridBagConstraints. CENTER, 

gbl, p, (Frame) this) ; 
GuiAddFields .AddButton ("Restore State", 1, gridy, 
GridBagConstraints .CENTER, 
gbl, p, (Frame) this) ; 

360 searchLearn = 

GuiAddFields .AddButton ("Search & Learn", 3, gridy, 
GridBagConstraints . CENTER, 
gbl, p, (Frame) this) ; 

searchOnly = 

365 GuiAddFields .AddButton ("SearchOnly", 5, gridy, 

GridBagConstraints . CENTER, 
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gbl, p, (Frame) this) ; 



gridy+=2 ; 

370 GuiAddFields .AddEmptyLine (gridy++, fnt, gbl, p) ; 

GuiAddFields .AddBut ton ("Exit Agent", 2, gridy, 
GridBagConstraints .CENTER, 
375 gbl, p, (Frame) this) ; 

^^1r1fif*ifiriti(ieitii**ie*1tieieir*ieit*icie**itie**ititit*iF*itit*irit*** 

/* general settings */ 
380 setBackground (Color .gray) ; 

addWindowListener (new DW Adapter ( ) ) ; 

scroll .add (p) ; 
add ( "Center" , scroll) ; 
385 add ("West", new Label ( " ")); 

add("East", newLabel(" ")); 
add ("South", new Label ( " ")); 

} 

390 public void itemStateChanged (ItemEvent event) 

{ 

if (event .getltemSelectable 0 == allEngines) 

{ 

engines . setvisible ( false) ; 

395 } 

else if (event .getltemSelectable {) == selectEngines) 

{ 

engines. setvisible (true) ; 

} 

400 else if (event .getltemSelectable ( ) == textQuery) 

{ 

tfQuery. setEdi table (true) ; 
tfRootSetSize. setvisible (true) ; 
tfQueryRef ineFactor . setvisible (true) ; 

405 queryRefine . setvisible (true) ; 

searchLearn . setvisible (true) ; 
searchOnly. setvisible (true) ; 
addSites . setvisible (false) ; 

} 

410 else if (event .getltemSelectable ( ) == linkQuery) 

{ 

tfQuery . setEdi table (true) ; 
tfRootSetSize. setvisible (false) ; 
tfQueryRef ineFactor . setvisible (false) ; 
415 queryRefine . setvisible (false) ; 

searchLearn. setvisible (true) ; 
searchOnly . setvisible (true) ; 
addSites . setvisible (false) ; 

) 

420 else if (event .getltemSelectable ( ) == repSites) 

{ 

tfQuery . setEdi table (true) ; 
tfQueryRef ineFactor . setvisible (false) ; 
queryRefine. setvisible (false) ; 
425 searchLearn. setvisible (false) ; 

searchOnly . setvisible (false) ; 
addSites . setvisible (true) ; 
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} 

} 



public void ac tionPer formed (Act ionEvent event) 

{ 

String command = event .get Act ionCommand () ; 



if ( command == "Refine Query" ) 

{ 

Agent. Action action = (Agent .Action) new Agent .Act ionRefineQuery 
{ tf Query .getText () , 

440 new Integer (tfQueryRefineFactor .getText ()). intValue () , 

tf Query) ; 
agent . setAction (action) ; 

} 

else 

445 if ( command == "Add Sites" ) 

{ 

Agent. Action action = (Agent .Action) new Agent .Act ionAddSites 

(tfQuery .getText 0 ) ; 
agent .setAction (action) ; 

450 } 

else 

if (command == "Select File..." ) 

{ 

FileDialog fd = new FileDialog (this, "Agent File"); 
455 f d . show ( ) ; 

if (fd.getDirectory ( ) != null && fd.getFileO != null ) 
tfOutputFile . setText (fd.getDirectory () +fd.getFile ( ) ) ; 

} 

else 

460 if (command == "Trace..." ) 

{ 

TraceDialog td = new TraceDialog (this, 

"Agent Trace Options", 
Trace . AGENT_TRACE , 
465 trace ) ; 

td . show ( ) ; 

} 

else 

if (command == "Save State") 
470 { 

FileDialog fd = new FileDialog (this, "Agent File"); 
f d . show ( ) ; 

if (fd.getDirectory 0 != null && fd.getFileO l= null ) 
{ 

475 String fileName = fd.getDirectory () +fd.getFile 0 ; 

try 

{ 

ObjectOutputStream oos = 

new ObjectOutputStream (new FileOutputStream(f ileName) ) ; 
480 agent . saveState (oos) ; 

oos . flush ( ) ; 

oos. close 0 ; 

} 

catch (Exception e) 
485 { 

System. err .println ( "Error while saving the Agent's state : \n"+e) ; 

) 
} 
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} 

490 else 

if (command == "Restore State") 

{ 

FileDialog fd = new FileDialog (this, "Agent File"); 
f d . show ( ) ; 

495 if (fd.getDirectory 0 != null && fd.getFileO != null ) 

{ 

String fileName = fd.getDirectory () +fd. get File () ; 
try 

{ 

500 Obj ectlnputStream ois = 

new Obj ectlnputStream (new FilelnputStream (fileName) ) ; 
agent . restoreState (ois) ; 
ois .close 0 ; 

} 

505 catch (Exception e) 

{ 

System. err -println ( "Error while saving the Agent's state : \n"+e) ; 

} 
} 

510 } 

else 

if ( command == "Exit Agent") 

{ 

Agent. Action action = new Agent .Act ionExit () ; 
515 agent . setAction (action) ; 

} 

else 

if (command == "Search & Learn" | | command == "Search Only") 

{ 

520 boolean update = command == "Search & Learn" ? true : falser- 

boolean goodlnput = true; 

SearchEngine [] searchEngines = null; 

if ( tfOutputFile.getTextO .length 0 == 0 ) 
525 { 

StatusDialog sd = new StatusDialog 

(this, "Bad Input ", "Output File Must Be Chosen!"); 
sd . show ( ) ; 
goodlnput = false; 
530 } 

if ( textQuery.getStateO && 
tfRootSetSize.getText 0 .length 0 == 0 ) 

{ 

StatusDialog sd = new StatusDialog 
535 (this, "Bad Input", "Size of Root Set Must Be Specified!"); 

sd . show ( ) ; 
goodlnput = false; 
} 

if ( t f Query. getText 0 .length {) == 0 ) 
540 { 

StatusDialog sd = new StatusDialog 

(this, "Bad Input ", "Query Must Be Specified!"); 
sd . show ( ) ; 
goodlnput = false; 
545 } 

if ( tfExpandFactor .getText 0 . length () == o | | 
tfNumResults.getTextO .length 0 == 0 ) 

{ 

StatusDialog sd = new StatusDialog 
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550 (this, "Bad Input" , "Expand Factor/Num. Results Must Be Set!"); 

sd.showO ; 
good Input = false; 

} 

if ( allEngines .getState ( ) ) 
555 { 

searchEngines = new SearchEngine [SearchEngine.NUM_ENGINES] ; 
try { 

// prepare an array of all search engines 
for ( int i = 0; i < SearchEngine .NUM_ENGINES; i++ ) 
560 searchEngines [i] = SEManager .ENGINES [i] . seClone 0 ; 

} 

catch (CloneNotSupportedException e) 

{ /* clone is supported by the Search Engine classes*/} 

} 

565 else 

{ 

int[] selectedEngines = engines .getSelectedlndexes () ; 

if ( selectedEngines. length == 0 ) 
570 { 

StatusDialog sd = new StatusDialog 

(this, "Bad Input "Engines Must Be Chosen!"); 
sd . show { ) ; 
goodlnput = false; 

575 } 

else 

{ 

searchEngines = new SearchEngine [selectedEngines . length] ; 
try 

580 { 

// prepare an array with clones of the selected engines 

for ( int i=0; i<selectedEngines . length; i++ ) 
searchEngines [i] = (SearchEngine) 
SEManager .ENGINES [selectedEngines [i] ] .seCloneO ; 

585 } 

catch (CloneNotSupportedException e) 

{ /* clone is supported by the Search Engine classes*/ } 

} 
} 

590 

i£ (goodlnput) 
{ 

Agent. Action action = textQuery .getState () ? 
(Agent .Action) new Agent .Act ionText Query 
595 ( t f Query . getText ( ) , 

II Aya 20.10.99 - changed the paradigm, the user must refine 

the query 

// explicityly by clicking the refine query 

button 

600 // no automatic refinement during query execution 

/* new Integer 

(tfQueryRefineFactor .getText 0 ) .int Value () , */ 
0, 

new Integer (tfRootSetSize .getText ()). intValue () , 
605 new Integer (tf ExpandFac tor .getText ()). intValue 0 , 

new Integer ( t f NumResul ts . getText ( ) ) . intValue ( ) , 

new Float (tfMaxLinkWeight .getText 0 ) . f loatValue ( ) , 

t fOutputFile. getText 0 , 

searchEngines , 
610 update) : 
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(Agent .Action) new Agent .Act ionLinkQuery 
(tfQuery .getText ( ) , 
new Integer (tfExpandFactor .getText () ) .intValueO, 
new Integer (tfNumResults .getText () ) .intValueO , 
new Float (tfMaxLinkWeight .getText ( ) ) . f loatValue ( ) , 
tfOutputFile. getText () , 
searchEngines , 
update) ; 
agent . setAction (action) ; 

} 

) 

else 

{ 

System. out. print In ( event ) ; 

} 

return; 

} 

public final void 
setPhase (String phase) 

{ 

tf Phase. setText (phase) ; 

} 

public final void 
setNSites (int n) 

{ 

tfNSites . setText (String. valueOf (n) ) ; 

} 

public final void 
setLeft (int n) 

{ 

tfLef t . setText ( String. valueOf (n) ) ; 

} 

public final void 
setServQIn (int n) 

{ 

tfServQIn. setText (String. valueOf (n) ) ; 

} 

public final void 
setServQOut (int n) 

{ 

tfServQOut . setText (String. valueOf (n) ) ; 

} 

public final void 
setServQUtil (int n) 

{ 

tfServQUtil. setText (String. valueOf (n) ) ; 

} 

class DWAdapter extends windowAdapter 

{ 

public void windowClosing (WindowEvent event) 

{ 

agent .exit ( ) ; 

} 

} 
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